Cream of the Crop 3/Cream of the Crop 3.iso/utility/csap421.zip/READ.ME

Text File | 1994-02-25 | 8KB | 162 lines

CSAP - Sort And Pack Directories [C source]

Author:  Don A. Williams

Version: 4.2.1   Date:    February 25, 1994

Fixed  a  bug that appeared when the TRUNCATE option was specified and  there
where just enough active entries in a directory to require an integral number
of  clusters  -  in  this case,  CSAP attempted to write  out  one  too  many
clusters.   Some minor, cosmetic changes were also made.   There have been no
reports  of  CSAP  use with any of the disk compression  facilities  such  as
DoubleSpace, Stacker, or SuperStore yet and I don't use any of them.  Be VERY
careful if you use CSAP with one of these facilities.

Version: 4.2.0   Date:    February  5, 1994

Finally,  the problem with large partitions appears to be fixed!   I  finally
got a system with a single 200 meg partition and tracked down the bugs!   The
special modifications to the absread/abswrite functions made in Version 4.1.0
by  Edgar  Swank are no longer necessary.   Borland fixed  their  version  of
absread/abswrite to handle partitions > 32  meg.   The major problems were  a
number  of  calculations  that  should have been "long"   and  actually  were
"unsigned".   This version, again,  has NOT been tested on a large variety of
configurations - I only have the one system with a large partition - and must
be used with care!

Version: 4.1.0   Date:    January 3, 1994

This version is another attempt to fix the problem with large partitions.   I
had some external help with this one from Edgar W.  Swank.  I  have no system
on  which I can test the large partitions - the largest partition on my  main
system is 60meg.   Mr.  Swank located and fixed a couple of the problems  for
me.


Version: 4.0.0   Date:    September  9, 1993

This version attempts to fix the long standing problem with large partitions,
i.e. FATs larger than 64k.  It MUST be considered as a "Beta" test version!


Version: 3.2.1   Date:    September 25, 1992

This version reinstates the "truncate"  option that was destroyed by  version
3.2.0.  It also fixes a long standing error it writing the second copy of the
FAT when  a  directory has been truncated.   The  version/date  printout  are
corrected in this version too!

Version: 3.2.0   Date:    February 20, 1992

A  total reimplementation of the handling of erased entries  that  eliminates
the "cross linked files" problem.  Evidently, some of the disk organizers pay
no  attention  to  the "end of directory"  sentinel unless it occurs  at  the
physical end of the directory.   CSAP now zero-sets all entries at the end of
the directory.   The truncate directory option is,  temporarily,  crippled in
this version.

Version: 3.1.2   Date:    February 19, 1992

Minor change in the handling of erased entries in an attempt,  only partially
successful,  to eliminate the "cross linked files"  problem that occurs  when
CSAP  is  used  in conjunction with some of the  "disk  organizer"  programs,
notably Central Point Software's COMPRESS and the Shareware DOG.

Version: 3.1.1   Date:    February 14, 1991

Made  a  very  minor change to allow CSAP to run under   MS-DOS   5.0.    The
change amounted  to nothing more than allowing "5" as a DOS version number.

Version: 3.1.0   Date:    July 11, 1990

Repaired    a    rather   major   problem   with   the    '-t',      Truncate
Directories,  option   and  empty  directories.   If  there  was  a directory
consisting of nothing but erased  files  and  CSAP  was executed  WITHOUT the
'-t' option and,   later,   CSAP was executed WITH the '-t'  option, many bad
things including corruption of the disk could occur! Also corrected the count
of freed clusters which was one too high and added a count of the freed bytes
to the message.


Version: 3.0.2   Date:    June 20, 1990

Since  the  absread()  and  abswrite()  functions  provided  with version 1.0
of  Borland  International's  Turbo C++  support the  long  sector  addresses
required by partitions larger than 32 meg,  the special routines used by CSAP
are  no  longer  needed and have  been removed.   The GetDPB()   function was
recoded to  eliminate assembly language at the same time.  Added  a   message
showing  the  number  of clusters freed by the "Truncate Directories" option,
'-t', and fixed a small bug in the truncation routine.

Version: 3.0.1   Date:    June 18, 1990

Version 3.0.1 of CSAP is nothing more  than  a  recompilation  of CSAP  using
Turbo  C++ 1.0.  It is slightly smaller and slightly faster than CSAP 3.0.0.

Version: 3.0.0   Date:    May 11, 1990

Version  3.0.0   of  CSAP can handle MS-DOS  4.xx  and  DR   DOS   3.xx large
partitions.    It   also   introduces   the  optional  ability  to   truncate
directories,    i.e.   release unused directory disk  space back to  the free
space  pool.   CSAP now uses Chris Blum's Absolute Disk   I/O   modifications
but  only   the  OBJ file for the Compact model in  included  in   the   CSAP
ZIP.  The entire   package   is available  on  CompuServ  in  IBMPRO  Library
#3    as ABRD40.ARC.  Version 3.0.0 of CSAP MUST be regarded as a "beta test"
version  -there  are now many different possible configurations and  I   have
not  been able to test them all.   It has been tested with MS-DOS 3.3  on the
small partitions that 3.3  can handle and  with  MS-DOS 4.01  and DR DOS 3.41
on small partitions and on large partitions up to 70  meg.    I  would highly
recommend that you take a full save of your hard disk before using CSAP 3.0.0
until you are sure that it works with your particular setup.

Version  2.1.1   of CSAP corrects the incorrect sorting on Date/Time that was
reintroduced in CSAP 2.0.9 and  later  versions.  Thanks to David Klatzco for
reporting it.

Version 2.1.0  of CSAP corrects the handling of the '.'   and  '..' directory
specifiers   and  adds  the  documentation  of the '-V'  option  to  CSAP.DOC
(the '-V'  has been operative in  the  program for some time but was left out
of the documentation.)

CSAP  is  composed of 5 modules;   CSAP.C,  SORTDIR.C,   ISDEV.C.C, GETDPB.C,
and ABSREAD.OBJ.  The current version  of  CSAP,   CSAP 3.0.0ß,    has   been
designed    for  compilation  with  Borland International's  Turbo   C   2.0.
The  module   ISDEV.C   could  be replaced by  Turbo  C's  supplied  function
isatty(), however, I plan to extend ISDEV.C to distinguish among files,  CON,
AUX,   and the printer.   The function isatty()  just  distinguishes  between
files and the others.

GETDPB.C cannot be compiled in Turbo C's interactive  environment (TC).    It
is   primarily   inline   ASM   code  and  requires  the  more   conventional
environment  provided by  Turbo C's TCC command.   As a  result,    CSAP  was
designed  to  be  compiled  through the  use  of  a  MAKEFILE  and  the  MAKE
facility of Turbo C.

CSAP currently  compiles  and  executes correctly  in   any   of   Turbo  C's
supported   memory   models  except HUGE.   The memory model is defined  as a
macro in the MAKEFILE and is supplied  on  the  MAKE command line, i.e.:

MAKE -DMDL=s

to make a SMALL memory model version of CSAP  (the  "s"  must  be lower  case
since   it   is   a   parameter   to  TCC and TCC is  case  sensitive  on its
parameters).   The resultant  EXE  file  will  be named  CSAPx.EXE where  'x'
is C,   S,   M,  or L depending upon the memory model selected.   The default
memory model  (if -DMDL is not specified on the MAKE command)  is the COMPACT
model.   The  current MAKEFILE will NOT work properly for  the  TINY   memory
model,  the library  specifications in the MAKEFILE would have to be modified
to  use  the SMALL libraries for the TINY model and the  effort  is  probably
not worth it. The command:

TCC -mt -G csap sortdir isdevice getdpb

would  have   to be used to produce a TINY memory model version of  CSAP  and
would produce an EXE file with the name CSAP.EXE.

The  EXE  and OBJ files in the CSAPxxx ZIP have been produced for the COMPACT
model which is probably the most general.